home *** CD-ROM | disk | FTP | other *** search
/ Magnum One / Magnum One (Mid-American Digital) (Disc Manufacturing).iso / d18 / turbcomm.arc / TC.DOC < prev    next >
Encoding:
Text File  |  1989-06-30  |  9.0 KB  |  216 lines
  1.  
  2.  
  3.  
  4.                                   TURBOCOMM
  5.  
  6.                          A Terminal Emulation Program
  7.                   
  8.                     by Stew Stryker, RONNIE Support Group
  9.  
  10. ------------------------------------------------------------------------------
  11.                                DISCLAIMER
  12.  
  13.       The author and Digital Equipment Corp absolve  themselves  of  any
  14.       possible  warranties  as  to the capabilities of this program, the
  15.       contents of this document, and specifically disclaim  any  implied
  16.       warranties  of  effectiveness.    They shall not be liable for any
  17.       lost profits, or for any claim or demand against them.
  18.  
  19.       The program is donated to the public domain, and  as  such  should
  20.       not  be  distributed  for profit.  The program is provided "as is"
  21.       and no technical support  by  Digital  or  the  author  should  be
  22.       assumed. 
  23. ------------------------------------------------------------------------------
  24.  
  25.  
  26.  
  27.       INTRODUCTION
  28.  
  29.       This terminal emulation program was  written  entirely  in  MS-DOS
  30.       Turbo Pascal (tm Borland International) for the DEC Rainbow.  It's
  31.       main purpose is to act as an example program showing  how  to  use
  32.       the  MS-DOS  communication  library.    Its secndary purpose is to
  33.       provide support for ReGIS emulation in the Digital A-to-Z environ-
  34.       ment.  It requires MS-DOS 2.05 or greater to run.
  35.  
  36.  
  37.  
  38.       FEATURES
  39.  
  40.       Along with providing basic terminal emulation  capabilities,  this
  41.       package supports:
  42.  
  43.         * User selection of baud rate on program startup
  44.         * Directing characters received from the host to the local printer
  45.         * Sending text files to the host computer
  46.         * Receiving text files from the host computer
  47.         * User selection of either VT2xx or VT102 emulation
  48.         * Digital's A-to-Z video graphics requirements
  49.         * ReGIS terminal emulation software
  50.         * Terminal Identification inquiries
  51.         * Full function key support
  52.         * Enter and save your own function key definitions
  53.         * Commands to change Numeric Keypad mode
  54.         * Terminal resets escape sequence trapping
  55.         * Printer controller commands
  56.         * Responding correctly to Printer Status Inquiries
  57.         * The Break key
  58.                                      
  59.  
  60.  
  61.       DIRECTIONS
  62.  
  63.       STARTING THE PROGRAM:
  64.       
  65.                 type:         TC {T} {VT102} {baud rate}<CR>
  66.  
  67.       
  68.       The braces {} in the command line indicate that those portions are
  69.       optional.
  70.  
  71.       The 'T' indicates that you wish to go immediately into Terminal
  72.       emulation mode, by-passing the initial help display.
  73.  
  74.       The default terminal emulation mode is a VT2xx.   You  may  select
  75.       VT102 emulation by typing 'VT102' in the command line.
  76.  
  77.       The 'baud rate' selects the baud rate you want the program to  run
  78.       at  (which,  of course, must be compatible with your modem or data
  79.       line).  The baud rate may be one of the following:
  80.  
  81.                   110 150 300 600 1200 2400 4800 9600
  82.  
  83.       If no baud  rate  is  selected,  the  program  uses  your  default
  84.       communications settings (established in the Rainbow Setup mode).
  85.  
  86.       The program first displays help information  on  how  to  use  the
  87.       function  keys.    At  this  point, you either press <DO> to enter
  88.       terminal emulation mode, <HELP> for more information, or <EXIT> to
  89.       return to the operating system.
  90.  
  91.       For example, to start the program running at 1200 baud instead  of
  92.       your  default  baud  rate,  and skipping over the initial display,
  93.       type:
  94.  
  95.                                     TC T 1200<CR>
  96.  
  97.  
  98.  
  99.       TO USE THE FUNCTION KEYS
  100.       ONCE YOU ARE IN TERMINAL EMULATION:
  101.  
  102.       All the function keys, except <PRINT SCREEN>,  <BREAK>  and  <F4>,
  103.       will  transmit  their  standard  escape  sequences  to  your  host
  104.       computer.
  105.  
  106.         <BREAK> will send a break signal for .25 seconds.
  107.         
  108.         <F4> puts you in command mode for a single command.
  109.         
  110.         <PRINT> does nothing.
  111.                                                           
  112.  
  113.  
  114.       COMMAND MODE:
  115.       
  116.       From terminal emulation mode, press the <F4> key, followed
  117.       by the letter highlighted for the function you want:
  118.  
  119.         Close      - If you are receiving a text file from the
  120.                      host computer, this will stop receiving the
  121.                      text, and close the file.  When you've success-
  122.                      fully closed the file, your screen will flash.
  123.                            
  124.         Disconnect - Drops the DTR signal to your modem, which
  125.                      will hang up your phone.
  126.  
  127.         Printer    - Toggles sending the displayed text to your
  128.                      printer on and off.
  129.  
  130.         Quit       - Disconnect and exit.
  131.  
  132.         Receive    - Allows you to capture all characters from
  133.                      your host onto a file on your Rainbow.
  134.  
  135.         Send       - Lets you send a text file from your Rainbow
  136.                      to your host computer.
  137.  
  138.         eXit       - Ends running TurboComm.  This does not drop 
  139.                      your DTR signal, so that your modem may still be con-
  140.                      nected to your host computer.
  141.  
  142.       If you type any other character, besides  those  listed  above,  a
  143.       line of help text will be displayed.
  144.  
  145.       You can  also  define  most of the function keys on your keyboard, 
  146.       including: 
  147.       
  148.               INTERRUPT            FIND                F17
  149.               RESUME              INSERT              F18
  150.               CANCEL              REMOVE              F19
  151.               MAIN SCREEN            SELECT              F20
  152.               EXIT                PREV SCREEN             HELP
  153.               ADDTNL OPTIONS      NEXT SCREEN             DO
  154.       
  155.       These  keys  are  defined  from  the command mode, by pressing the 
  156.       function  key  you  wish  to  redefine.    You  then  type in your 
  157.       definition, and  press  <F4>  to end the definition.  A definition 
  158.       may contain any sequence of less than 80 keyboard characters.  
  159.  
  160.       When you exit TurboComm, you will be asked if you wish to save the 
  161.       definitions.  If so,  you  will  be  prompted for a filename, with 
  162.       TC.KEY as the default.  If you have defined a default function key 
  163.       directory (see below), the file will be created in that directory, 
  164.       otherwise, it will be created in the current directory.
  165.  
  166.       The next time you start up TurboComm,  the function key definition 
  167.       file will be loaded automatically.
  168.       
  169.  
  170.       DEFINING A DEFAULT FUNCTION KEY DIRECTORY
  171.       
  172.       With the  latest  version  of  TurboComm, you can define a default 
  173.       directory for your  function key definitions.  TurboComm will read 
  174.       the MS-DOS Environmental Variable  'TC_DIR'  for  the  name of the 
  175.       directory you keep your key  definition  files.  This will be used 
  176.       for both the default function key  file,  as well as any you might 
  177.       use  on  the TC command line.  That  is,  if  you  define  TC_DIR, all 
  178.       your function key definition files must reside there.
  179.       
  180.       For example, type:   SET TC_DIR=E:\COMMAND
  181.  
  182.       would cause TC to look for TC.KEY in E:\COMMAND subdirectory.
  183.  
  184.  
  185.       TO COMPILE TURBOCOMM SOURCE CODE
  186.       
  187.       (You can run TC.COM directly, without recompiling the source code.
  188.       If  you  want  to  modify  the program yourself, you'll need these
  189.       instructions.)
  190.  
  191.       First, you must break the library file, TC.LBR, into its  separate
  192.       files  with  the  LU.EXE utility (not included).  To break out all
  193.       the components, type:  
  194.                             LU A TC.LBR<cr>
  195.  
  196.  
  197.       Next, you will probably want to edit the  main  file  (TC.PAS)  to
  198.       match  the  version of MS-DOS Turbo Pascal you're using.  This was
  199.       originally developed under Turbo Pascal version 2.0.  At the  last
  200.       minute,  my  update  to  3.0  arrived  and  I modified some of the
  201.       procedures to take advantage of some new capabilities.   Therefore
  202.       some of the code requires Turbo Pascal 3.0 or greater.
  203.  
  204.       I did the only decent thing, and left the version 2.0 code in  the
  205.       program,  but  commented  it  out.  If you're compiling with Turbo
  206.       3.0, you can compile this "as is" (Though you may want  to  remove
  207.       the  version  2.0  code  altogether.) If you are still using Turbo
  208.       2.0, search through the source code in TC.PAS for  all  occurances
  209.       of 'Turbo Pascal 3.0', and remove those routines.  Then search for
  210.       the sections marked with '< 3.0' and remove the comment marks ( {}
  211.       ), to activate those functions.
  212.  
  213.       After you've created the version of TC.PAS you  need,  you  simply
  214.       compile it as you would any other Turbo Pascal program.
  215.  
  216.